Scrapbox to Markdown
1 Scrapbox記法をMarkdown記法に変換すること
2 同上、sta.iconがつくったツール
ここでは2を扱う
背景
承認欲求満たしたい
ScrapboxだとSEOが弱いし、そもそも承認成分を持ち込みたくない
どうするか
静的サイトに変換すればいい
1ページを1ファイルに変換する
GitHub Pagesが楽そうでいいかな
titやmonolithicみたいなテイストをイメージしている
つまりMarkdownに変換する
resources
repo
https://github.com/stakiran/scbjson2ghpages/
ややこしいがreponameはscbjson2ghpages
testdata
/testdata-for-to-markdown
サンプル
scrapbox-sta
現状 at 2021/09/01
できてる
/staのページの大部分を正しく変換できることは確認済
Markdownの「リストと段落の塊」の表現力が弱い件なども対処できている
できてない
どこかに載せる
scrapbox-sta側のタスクとして検討している（そして全敗）しているが、7000+のページ数（ファイル数）を置けるサービスがない
❌scrapbox-staがGitHub Pagesに載らない問題
拡張性の担保
scrapbox記法のパースを行指向でやってしまったせいで、ロジックがアホみたいに煩雑になっている（開発者本人であるsta.iconでも理解キツイ）
処理時間の長さの解消
jsonのでかさにもよるが、7000ページあると7000ファイルつくることになるのでI/Oがネック
hr.icon
以下作業メモ
scrapbox-staのタスクはそちらに置いてる
motivation
2021/09/24 /sta/僕のプロジェクトたちで扱ってたけどモチベと必要性微妙なのでいったん下ろす
todo
SpecialPagesにクライン系をサポートする
projectのjsonを丸々変換するのをやめる案
たぶん「要約リストを作るツール」にしたほうがいい
✅SpecialPagesの「リンク先がScrapboxになっている」版をサポートする
他にも色んなSpecialPagesをサポートする
指定タグをハードコードしているのがおかしいので引数化する
1-scrapbox-page 1-fileではなくN-scrapbox-page 1-fileにする
ビルドにCPUパワーとI/Oを酷使するので何とかする
パイプ直書きでpipe trapが発動するのを防ぐ
デバッグプリント用フラグを実行時コマンドラインオプションで与える
DrawingなどScrapboxのストレージを使っている画像を表示する
各ページに「view on scrapbox」リンクをつける
リンクの種類を視覚的に区別する
解析的にむずかしい
引用中のリンクを反映させる
アスタリスクを2つ以上重ねた太字表記内のリンクも正しく変換する
cssで(icon記法からつくった)絵文字を強調する
アイコン記法を画像として埋め込む
でかすぎるリンクとその接続先を表示するページ
タグ名指定出来たほうがいいかも
index.mdに書く「projectごとに固有の部分」を自由にいじれるようにする
自分のiconが多い順のSpecialPageを追加する
Linksの表示順序を上手い感じに並び替える
✅レンダリングエンジンを模索する
✅レンダリングエンジンをMkDocsに変える
❌レンダリングエンジンをPandocに変える
❌レンダリングエンジンをHugoに変える
✅Linksに載せるリンク数はオプションで指定できるようにする
✅Linksに相当するFooterをつける
16-8-4 cutはもうちょっとなんとかしたい
❌F,T,H limitを微調整してちょうどよい塩梅を探す
❌scrapbox-staのJekyllビルドのどこがおかしいかを調べる
✅リスト中のブロックを含んだページの変換に穴があるのを修正する
✅全ページリンク集をつくる
✅各ページに大見出しを入れる
✅各ページにタイトルを入れる
✅結果的に_から始まるファイル名にアクセスできないので何とかする
✅jekyllで日本語ファイル名が正しくリンクされない問題を修正する
✅GitHub Pagesでsourceをルートにしている場合に、ルートにアクセスしてもindex.htmlに転送されない
✅Gyazo埋め込みの画像を表示する
✅index.mdを自動生成する
testpageでテストしたいやつ
✅画像にリンク貼ってる場合に表記がおかしい件の修正
✅アイコン記法の後に文字を書くと解釈がおかしくなるのを修正する
✅リンクの後にアイコン記法が続く場合に変換がおかしくなるのを修正する
✅URL直書きをリンクにする
✅リンク中に|(パイプ)が含まれるとテーブルとして解釈されてしまう問題
サンプルつくるまでの作業ログ
種々のタスクをScrapbox上でどうまとめるかを検討する
sta.json加えてghpagesリリースします
Scrapbox to Markdown sta.jsonを食わせて全部通るまで帰れま１０
Scrapbox to Markdown リスト中のテーブルやらコードやらブロック
Scrapbox to Markdown テーブル
ファイル内容が一致していてもリストとリストをassertEqualしていればFalseになることがある
Scrapbox to Markdown コードブロック
Scrapbox to Markdown 画像の実装はいったん捨てる
Scrapbox to Markdown 画像とicon記法の実装
Scrapbox to Markdown テストコード設計
Scrapbox to Markdown 文法変換の設計やら実装やら
2021/04/07 Scrapbox to Markdown 基本方針
sta.icon時期結構離れてる
突然モチベーション湧いたんだよなぁ
あとちょうどHouse2検討始めて他のタスク（≒いせむげ）を手放したからってのもある
2020/06/27 Scrapbox to Markdown 事前調査
#開発ネタ